Pepper Money - Asset Finance Originations API

Solana has a feature to send push notifications to external systems whenever a deal changes its status. In order to use this feature, External systems should configure a listening API to receive these

notifications and should register these APIs with Solana.

As part of these notifications, Solana sends The Application status, notes, credit and settlement conditions, and other application details. These notifications are sent as soon as the status of the application

changes in Solana.

Security

Solana supports oAuth2 with client credentials as a preferred authentication mechanism while calling the external Listening APIs.

1. OAuth2 with client credentials - To use this Authentication mechanism the following data needs to be configured.->Access Token Endpoint.-> Field name of access token in the Access token response.-> header values to send while requesting access token for the below standard headernames:- grant_type,client_id,scope,client_secret

Note: You will be required to pass Ocp-Apim-Subscription-Key only if the callback API is hosted on Azure server.

Call Back URL

Method : POST

Content- Type : JSON

Request body:

Example:

{
    "applicationReferenceId": "AD-1003484",
    "brokersReference": "Application From API",
    "status": "Approved",
    "totalAssetCost": 80001,
    "deposit": "",
    "tradeIn": 100,
    "payOutAmount": 0,
    "netAssetCost": 80001,
    "applicationCreationDate": "29/06/2021 18:16 GMT+10:00",
    "notes": [
        {
            "notes": "somne \nmulti line\nnote with\nspec!@L ch@r@cTer$ andn\n\n\nempty lines",
            "user": "Credit Smith"
        },
        {
            "notes": "some dummy note added by the analyst during assessment",
            "user": "Credit Smith"
        },
        {
            "notes": "Please approve this application. They are a good customer with strong financial history that I have been working with for a number of years. They always meet their obligations and have a good employment and strong household financials",
            "user": "ABC Pty Ltd Broker"
        }
    ],
    "conditions": {
        "creditConditions": [
            {
                "creditConditionId": 13208,
                "condition": "Bank Statement required",
                "creditOfficerNotes": "note added to the credit condition by analyst",
                "isAssessed": true
            },
            {
                "creditConditionId": 13209,
                "condition": "Maximum Monthly Repayments",
                "creditOfficerNotes": "note added to the credit condition2 by analyst",
                "isAssessed": true
            }
        ],
        "settlementConditions": [
            {
                "settlementConditionId": 13175,
                "condition": "Provide copy of Certified ID",
                "creditOfficerNotes": "Note by analyst",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13176,
                "condition": "Provide copy of Certified ID",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13177,
                "condition": "Proof of Income for each applicant (the 2 most recentpayslips)",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13178,
                "condition": "Provide completed & executed privacy declaration for all applicants",
                "creditOfficerNotes": "note 2 by analyst",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13179,
                "condition": "Provide completed & executed finance agreement",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13180,
                "condition": "Provide completed & executed application form for all applicants",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13181,
                "condition": "Tax invoice from supplier (including deposit slip with banking details if supplier is not accredited)",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13182,
                "condition": "Provide Tax invoice for Origination fee",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13183,
                "condition": "Evidence for property ownership for the borrower (e.g. current rates notice, or property title search)",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            },
            {
                "settlementConditionId": 13184,
                "condition": "Proof of Investment Income",
                "creditOfficerNotes": "",
                "settlementOfficerNotes": "",
                "status": "New",
                "isAssessed": false
            }
        ]
    }
}

Attribute	Data Type
applicationReferenceId	string	Unique Reference ID in Solana
brokersReference	string	Unique Reference ID in Solana
status	string	Current Status of the Application
notes	Array of Notes	Notes added in the current step. Only the notes that are added after the previous status update will be sent.
conditions	Array of settlement and credit conditions	All the active conditions in the Application

Error Handling

Solana has a retry mechanism where it will retry the Status Update API 3 times before sending an email to Solana's support team first and then to Broker’s support team. The broker’s support email address
should be configured when setting up the config details
example:

Hi,
An Error occurred while calling an API during the status update for the Asset Finance deal AD-1003378 in
Solana.
Error Details :
API : https://appflo-dev.pepper.com.au/suite/webapi/kyTMHQ
Title :Something went wrong
Message: Failed to connect to https://appflo-dev.pepper.com.au/suite/webapi/kyTMHQ
Details: Certificate for doesn't match any of the subject alternative names: [*.appiancloud.com, appiancloud.
com]
Please contact dl-paforiginations@pepper.com.au for further assistance regarding this error.
The link to application AD-1003378 is here.
Kind regards,
The Pepper Asset Finance Team